home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / apps / 573 / pathmap / pathmap.doc next >
Text File  |  1985-11-19  |  7KB  |  133 lines
  1.                             PathMap v1.0               November 12, 1991
  2.                       The Application Locator
  3.  
  4.       INTRODUCTION
  5.  
  6.       GEM's "Install Application" feature can be very useful. It
  7. saves typing in ARChive names you want to extract; it saves scrolling
  8. through file selectors to load the file you want to edit...Actually its
  9. uses are nearly endless. Except for one problem: your program must
  10. either be in the root directory of disk A (A:\) or in the same
  11. directory as your data file. This fact can virtually cut Install
  12. Application's usefulness down to zero. (For a more in-depth explanation
  13. on the Install Application refer to the Atari ST User's manual.)
  14. Fortunately, Atari decided to fix this for TOS versions 1.04 and
  15. above. But what about those of us with TOS 1.0 or 1.02?
  16.       This is where "PathMap" comes in. PathMap will install any
  17. program as an application. On top of this, it also includes the
  18. location of the program; now your program can be in any folder in any
  19. drive.
  20.       PathMap works by appending the application information
  21. (including its location, GEM doesn't do that) about your program to the
  22. DESKTOP.INF file of your choice. The next time (and every time after)
  23. you boot from that disk, GEM will load the application info into RAM.
  24. Allowing you to run a program by double-clicking on any file with the 
  25. extender you specify to PathMap.
  26.  
  27.       PathMap
  28.  
  29.       To run PathMap double-click on its icon from the GEM desktop.
  30. PathMap will run on any ST, STe, or TT. "Why would you want to use it
  31. on the STe or TT?", you ask. Because, also unlike GEM, PathMap allows
  32. you to install multiple document types to a single application. It
  33. works in High and Medium resolution. When you are presented with the
  34. "PathMap" dialog box choose "Install Application" to proceed, or "EXIT"
  35. to quit the program.
  36.       After selecting the "Install Application" button you will be
  37. presented with a file selector. From here choose the DESKTOP.INF file
  38. in the root directory of your boot disk. Click "OK" to proceed, and
  39. "Cancel" to return to the main menu. If the file does not exist, or it
  40. is a "read-only" file you file be informed and return to the file
  41. selector.
  42.       If you selected "OK" you will now be looking at another file
  43. selector. This time choose the program you want your data file to run.
  44. This is the equivelant to the program you have "selected" when
  45. installing an application via GEM. Again, click "OK" to proceed with
  46. the installation, or "Cancel" to return to the main menu. If the file
  47. does not exist you will be told so by a dialog box; you will then be
  48. returned to the second file selector.
  49.       After selecting "OK" (from the file selector) a dialog box will
  50. appear. First, select the type of program that your application is.
  51. Choose GEM if it is a "PRG" program (ie. it uses alert boxes, or menus
  52. and the mouse to get input, such as this program). Choose TOS if it is
  53. a "TOS" type program, (ie. one that does NOT use menus, dialogs, etc.,
  54. and does also not receive command-line input). Finally, choose TTP if
  55. your program is a "Tos-takes-parameters" program, (ie. it does not use
  56. alerts, menus, etc., but DOES take command-line arguments). To choose
  57. the "Document Type" to which the application will apply click on any
  58. one of the three underscore characters (_) just to the right of the
  59. "DOCUMENT TYPE:" string. Now enter three characters of text (eg. DOC
  60. for 1ST WordPlus, or ARC for ARC.TTP). Choose "OK" to confirm the
  61. entire process or choose "Cancel" to return to the main menu. Remember
  62. you must first BOOT with the DESKTOP.INF file you just altered before
  63. the application will be functional.
  64.       Removing an application installed by PathMap is the same as
  65. doing so if GEM had done the job: delete the DESKTOP.INF file by
  66. dragging it to the Trash icon. Remember that if you delete a
  67. DESKTOP.INF file in the hopes of removing an application DON'T save the
  68. desktop if you have booted with the now-deleted DESKTOP.INF file. The
  69. application will be installed in RAM and would be saved to the new
  70. DESKTOP.INF file.
  71.       Should you install two different applications, each with the
  72. same "DOCUMENT TYPE" the one installed _later_ will be the one GEM
  73. uses. For example, if you installed an application to the program, 1ST
  74. WordPlus using the extender DOC, and then installed an application to a
  75. file view utility clicking on any DOC file would load the file viewer,
  76. NOT 1ST WordPlus. Because of this it is not always necessary to delete
  77. DESKTOP.INF files when you want to install another application.
  78.       On a related note it is perfectly all right to install many
  79. different DOCUMENT TYPEs to the same program. To do this, just choose
  80. INSTALL APPLICATION (from the main menu) over and over until everything
  81. is installed like you want. This is especially useful for file view
  82. utilities. You could install an application for the many different text
  83. file extenders (eg. TXT, ASC, DOC).
  84.  
  85.      BUG(S)
  86.  
  87.       There is only one known bug in PathMap, and is fairly major; it
  88. gets back to the original problem of not being able to find files. I'm
  89. not sure if it really qualifies as a bug of PathMap or GEM. When you
  90. have an application not located in "A:\" or the same directory as your
  91. data file (which you should--because that is why you're using PathMap)
  92. the program you run might not know where its RSC (or CFG, DAT, etc.)
  93. files are. It "thinks" it's being run from the directory that contains
  94. the data file. In the event that the program has, included in its
  95. binary code, the disk to search for its RSC (and other) files on there
  96. is away around the above problem. Using a binary file editor it is
  97. possible to replace the disk/path string, such as A:\, with the
  98. programs actual location, such as F:\.
  99.       Because of the above problem I considered not releasing this
  100. program. However, with the turn toward imbedded resources (PathMap's
  101. resource is imbedded), as well as the many programs, such as ARC.TTP
  102. (or any other non-GEM programs) which have no resource or config files
  103. I decided in favour of releasing it. If anyone knows how to tell GEM
  104. that a program is being run from the folder it's IN, not the folder
  105. it's being run FROM, please let me know!
  106.  
  107.       PRICE, etc.
  108.  
  109.       PathMap is provided as FREEWARE. It costs nothing, copy it,
  110. upload it, download it, whatever you want as long as you neither charge
  111. for it, or modify the program (or this document) in any way. I would
  112. like to hear from anyone who likes (or doesn't) like PathMap. I would
  113. appreciate any suggestions (especially a way to fix the above problem!)
  114. for future versions. Please report ALL bugs to me; don't assume someone
  115. else already has.
  116.      
  117.       ADDRESSES
  118.       
  119.       John Perry
  120.       891 Palmerston Ave.
  121.       Winnipeg, Man.
  122.       CANADA   R3G 1J6
  123.  
  124.       Internet: marco@sys6626.bison.mb.ca
  125.       CompuServe: >INTERNET:marco@sys6626.bison.mb.ca
  126.       
  127.       LEGAL STUFF
  128.  
  129.       I make no guarantee as to the performance of this program and
  130. take no responsibility for any damage it may cause you, your computer,
  131. your data, etc. This program and this document file are copyright
  132. (C)1991 John Perry.
  133.